home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rbbsdocs.zip / RBBSDOCS.2 < prev    next >
Text File  |  1990-11-05  |  33KB  |  650 lines
  1.  
  2.  
  3.  
  4.     INSTALLING RBBS-PC                                                      2-1
  5.  
  6.  
  7.     2. INSTALLING RBBS-PC
  8.     ---------------------
  9.     RBBS-PC is a powerful application that may take months to master fully, but
  10.     gives those who stick with  it a practically ever expanding power  as their
  11.     knowledge and needs grow.  But it is not necessary to understand everything
  12.     or take advantage of all  its power, before it can be set  up initially, or
  13.     used.   This section  is  intended to  provide a  step-by-step approach  to
  14.     setting  up RBBS-PC.   Follow the  steps thoughtfully!   Do  not proceed to
  15.     subsequent steps until you understand all the previous steps.
  16.  
  17.     Our goal with persons getting started with RBBS-PC for the first time is to
  18.     get them off to a fast start by (a) bringing up the software to see how  it
  19.     runs, and  (b)  getting the  software  to be  able  to answer  an  incoming
  20.     telephone call.  A BBS  strongly reflects the interests and  personality of
  21.     it's SysOp, and RBBS-PC is one of the most flexible and customizable of the
  22.     BBS's.
  23.  
  24.     However,  for those  who are  NOT familiar  with electronic  bulletin board
  25.     systems  in general, a good introduction to installing RBBS-PC is contained
  26.     in the book  "Electronic Bulletin Board Starter  Kit" by Charles  Bowen and
  27.     David Peyton, published by Bantam  Books.  The book does in  436 pages what
  28.     the next few pages attempt to do.  It is a superb guide for someone who has
  29.     never setup a  bulletin board system  or is not  knowledgeable about PC  or
  30.     asynchronous communications.   The book  comes complete  with an  extensive
  31.     index as  well as  a copy  of RBBS-PC  Version  15.1C and,  of course,  the
  32.     associated  source  code.    Since  all  versions  of  RBBS-PC  are  upward
  33.     compatible, this book serves equally well as a guide for the uninitiated to
  34.     all subsequent versions of RBBS-PC.   This book guides the potential  SysOp
  35.     in easy stages from unwrapping the two diskettes that are included with the
  36.     book  to operating  the more  advance features  of RBBS-PC.   The  book was
  37.     published by Bantam Books in August of 1988, ISBN 0-553-34552-4, and can be
  38.     found  in most technical book and computer  stores.  It addresses the topic
  39.     of installing an electronic bulletin board  system in a far better way than
  40.     this "Technical Reference Guide" does.
  41.  
  42.     Because RBBS-PC attempts to  provide SysOps the maximum flexibility,  it is
  43.     perfectly possible for those setting RBBS-PC up for the first time to shoot
  44.     themselves in  the foot.  Be  patient with yourself.   Remember that things
  45.     worth achieving usually are not obtainable without effort.
  46.  
  47.     2.1 First Time Installation
  48.     ---------------------------
  49.     Do  not try  to do  everything at  once.   Keep  things simple  and proceed
  50.     patiently, a step at  a time, putting only one  thing in place.   The files
  51.     you  need  are  the  executables   (RBBS-EXE.ZIP)  and  system  text  files
  52.     (RBBS-TXT.ZIP).  RBBS-PC comes completely set  up, ready to run.   To  take
  53.     advantage of this set up, you must do the following:
  54.  
  55.     1.   Create a  new subdirectory on the hard drive of your computer.  "RBBS"
  56.          is a suggested name but any can be used.   The DOS command to make the
  57.          directory is "MD \RBBS".
  58.  
  59.     2.   Copy  the zipped files into the subdirectory.   You must have at least
  60.          RBBS-EXE.ZIP  and  RBBS-TXT.ZIP.   The DOS  command  to copy  is "COPY
  61.          <from> <to>", e.g. "COPY A:*.ZIP C:\RBBS".
  62.  
  63.     3.   Make the subdirectory you created your current one  ("CD \RBBS").
  64.  
  65.  
  66.  
  67.     RBBS-PC 17.3A            TECHNICAL REFERENCE MANUAL                     2-2
  68.  
  69.  
  70.     4.   Unzip the files using the command "PKUNZIP -d *".   You need to obtain
  71.          a copy of the program "PKUNZIP.EXE" to do this.
  72.  
  73.     Subdirectories will be created off the current directory.
  74.  
  75.     5.   Enter the command:  INSTALL.   This program will  check the  directory
  76.          structure, and inform you if  any files are missing or misplaced.   It
  77.          also  makes sure the RBBS-PC  configuration matches your  system.  The
  78.          file  INSTALL.LOG will  contain  information about  files the  install
  79.          procedure could not find, or had to move.  While many of the files are
  80.          OPTIONAL,  consult this  log if you  later encounter  problems running
  81.          RBBS-PC.
  82.  
  83.     You  are  now  ready  to  run  RBBS-PC!    RBBS-PC  comes   with  a  sample
  84.     configuration file, and small but empty  users and messages file.  To bring
  85.     up RBBS-PC, at the DOS prompt, type
  86.  
  87.                         RBBS[Enter]
  88.  
  89.     where  "[Enter]" means to press the "Enter" key.  RBBS is a batch file that
  90.     runs RBBS-PC,  and also controls certain RBBS-PC maintenance functions (see
  91.     section 13 for details).  In this first run, RBBS-PC does not to wait for a
  92.     telephone  call to establish communications through a serial port, but just
  93.     runs as a local application, communicating with you through the screen  and
  94.     keyboard.   You should see  a copyright  notice first, then  a "WELCOME  TO
  95.     RBBS-PC", a short message about a "prelog", and then be asked "What is your
  96.     First Name?"   What you see on your screen  beginning with the "WELCOME" is
  97.     exactly  the  same as  a remote  caller on  the  telephone line  would see.
  98.     Instead  of your real name, enter SECRET  NAME[ENTER].  This is the "secret
  99.     SysOp name" for the sample system.  Next, answer the questions RBBS-PC asks
  100.     you and look around.  Your only goal at this point is to make sure that the
  101.     software runs on your computer.
  102.  
  103.     The  next goal is to get RBBS-PC to answer an incoming call.  This requires
  104.     a  functioning communications port, modem,  and telephone line,  as well as
  105.     more configuration  information in RBBS-PC.  There are five things you must
  106.     normally do in preparation:
  107.  
  108.     (1)  Set the RBBS-PC modem commands properly for your modem, especially the
  109.          modem  initialization string  and firmware initialization  string (See
  110.          CONFIG parameter 225).
  111.  
  112.     (2)  Set  the hardware  switches on  the modem  properly, but  some modems,
  113.          especially "internal" modems, may have no hardware switches.
  114.  
  115.     (3)  Set  the communications port  to what the  modem is using  (see CONFIG
  116.          parameter 221).
  117.  
  118.     (4)  Initialize the modem's firmware.    This makes permanent  the settings
  119.          that RBBS-PC needs (see CONFIG parameter 231).
  120.  
  121.     In the  best of  all worlds,  the factory  settings of  the modem  are what
  122.     RBBS-PC wants and RBBS-PC's default settings  work, so that nothing at  all
  123.     must be changed.  This is normally the case for the USR Courier 2400 modem.
  124.  
  125.     Your  key to  setting everything  up is  the RBBS-PC  configuration program
  126.     called "CONFIG.EXE".  CONFIG is your guide to configuring RBBS-PC for  your
  127.     preferences  and  environment, and  basically is  just  a smart  editor for
  128.  
  129.  
  130.  
  131.     INSTALLING RBBS-PC                                                      2-3
  132.  
  133.  
  134.     setting up RBBS-PC.  RBBS-PC stores its configuration parameters  in a file
  135.     called "RBBS-PC.DEF".  To edit configuration file RBBS-PC.DEF, just type
  136.  
  137.                        CONFIG RBBS-PC.DEF[Enter]
  138.  
  139.     You will  see a copyright notice,  CONFIG will read in  the current values,
  140.     and then you will see  a table of contents for the many pages of parameters
  141.     you can set.  There are  over 300 parameters you can set in  RBBS-PC, which
  142.     can be  extremely complex.   Most  you will never  change, but  RBBS-PC has
  143.     tremendous power and  flexibility if and when you do need it.  You can just
  144.     press  the page down key "PgDn"  to see the many  screens of parameters, if
  145.     you  want to  browse.   Do not  be intimidated.   RBBS-PC, as  shipped, has
  146.     nearly  all of these  parameters set for  you.  For  more information, read
  147.     section 10.
  148.  
  149.     Once you have set the  modem parameters in CONFIG, and saved  your changes,
  150.     you are ready  to make sure  that RBBS-PC will  answer incoming calls.   Be
  151.     sure you have your modem connected and on.  Then type
  152.  
  153.                             RBBS[Enter]
  154.  
  155.     You should see a copyright screen.  RBBS-PC will draw a screen with  boxes.
  156.     The modem lights should flash, and RBBS-PC should display "Ready for Calls"
  157.     in a box.  Four lights on an external modem will normally be on: High Speed
  158.     (HS),  Auto Answer  (AA),  Modem  Ready  (MR),  and  Terminal  Ready  (TR).
  159.     Ideally,  you have  a second  computer beside  the first  with a  modem and
  160.     telephone  line that you can use to call the BBS.  Otherwise, have a friend
  161.     with a computer call  it.  You need to call with a  modem to make sure that
  162.     the two modems will talk.  When the call  comes in, the Ring Indicator (RI)
  163.     should blink.  Then the Off Hook (OH) and Carrier Detect (CD) lights should
  164.     come on as  the modems link.  And  RBBS-PC should chip in with  its opening
  165.     "WELCOME  TO" line, and the send (SD)  and receive (RD) lights should blink
  166.     periodically.   If the lights  blink but you  see nothing, you  may need to
  167.     turn on "snoop" so you  can see the session on your local  terminal.  Press
  168.     F9.   If that doesn't  do anything, press it again.   After the caller says
  169.     "Goodbye", RBBS-PC should recycle, the CD and OH lights go off, and the box
  170.     reappear that finally says it is again ready for calls.
  171.  
  172.     Once you have RBBS-PC answering  calls, you are ready to begin  customizing
  173.     the  board, setting it up the way you  want, and adding features.  You need
  174.     two primary  tools: CONFIG.EXE (part  of the RBBS-PC  package), and a  full
  175.     screen  editor  (which  you must  supply).    You  need  what is  called  a
  176.     "programmer's" editor  versus a word processor - one that only puts in what
  177.     you  type and  never inserts  any hidden  or special  characters -  what is
  178.     sometimes called as straight "ASCII" editor.
  179.  
  180.     Here we will walk you through what is behind what the caller sees on logon.
  181.     The  first message is "WELCOME TO  " followed by the name  of the board, as
  182.     specified in CONFIG parameter 12.
  183.  
  184.     Next the  file PRELOG is  displayed.   This file need  not be  present, and
  185.     generally should be brief, as it is displayed on every call.
  186.  
  187.     Callers  are then asked to  identify themselves, by  answering the question
  188.     "What is your FIRST name?"  The text after "your" can be set up with CONFIG
  189.     parameter  45, though  most SysOps  do not  change it  (e.g. "What  is your
  190.     ACCOUNT ID?").  The  next question is "What is your  LAST name?", which can
  191.     be set in parameter 46.
  192.  
  193.  
  194.  
  195.     RBBS-PC 17.3A            TECHNICAL REFERENCE MANUAL                     2-4
  196.  
  197.  
  198.     If the caller is not in the user's file,  which normally means that this is
  199.     a new,  first  time caller,  then  RBBS-PC displays  the  text file  called
  200.     NEWUSER.   Here you  should explain  the board and  the rules you  have for
  201.     people to follow.
  202.  
  203.     Callers next  see  a welcome  specific to  their security  level, called  a
  204.     "logon level greeting  file".  These  files take the  form LGnn.DEF,  where
  205.     "nn"  is their  security level (e.g.  level 10  callers would  see the file
  206.     LG10.DEF, if  it is  present in  the default directory).   Then,  a general
  207.     "welcome" file  is displayed.  The general welcome file shown to the caller
  208.     can be changed "on the fly" by RBBS-PC, dependent on  what sort of Graphics
  209.     option the caller has selected.   SysOps often use this for an  ANSI log-in
  210.     screen.
  211.  
  212.     There  are many other  things in RBBS-PC you  will want to  set up, such as
  213.     bulletins,  news,  and  conferences.   Just  remember  to  take your  time.
  214.     RBBS-PC almost always runs the FIRST time.   Make one change at a time  and
  215.     then test it so you don't break something that once worked.
  216.  
  217.     2.2 What's New In 17.3A?
  218.     ------------------------
  219.     17.3A is a maintenance release  for 17.3.    Over 100 changes were made  to
  220.     the code.   The most significant are:
  221.  
  222.     (a)  increased reliability, eliminating the following problems:
  223.  
  224.        - occasional constant recycling with "connect timeout"
  225.        - overflow error when modem not working right
  226.        - untrapped  errors, when FMS directory wrong and when trashcan file not
  227.          set up properly
  228.        - possible infinite loop in FMS search
  229.        - possible incorrect modem initialization in CONFIG
  230.        - problems with execution of external events after 9pm.
  231.  
  232.     (b)  autodownload now works properly
  233.  
  234.     (c)  problems with macros were fixed,  including repeat of prompts,  double
  235.          execution of a macro, assigns sometimes getting wrong values,  problem
  236.          with block print,  problem with  PUI's, and macros  associated with  a
  237.          protocol not being executed.
  238.  
  239.     (d)  problems fixed  with doors  include individuation not  restored, doors
  240.          need not  be listed on the menu if in DOORS.DEF, the registration door
  241.          will respect DOORS.DEF, and  bytes downloaded is now right  dooring to
  242.          external protocols.
  243.  
  244.     (e)  problems  fixed with  messages/conferences include  mail waiting  in a
  245.          conference  view works properly for the conference you are in, message
  246.          display  can be paused and interrupted, searches on subject work right
  247.          if subject not in upper case, TABS works in message entry, person with
  248.          SysOp status does have mail to  SysOp listed in mail scan, public name
  249.          of SysOp recognized as SysOp, no longer says receiver will be notified
  250.          of new mail when not in user's file, join to main works  in conference
  251.          view function, support added to allow  names to have a netmail address
  252.          ("@ <node>" on end), and subject prompted for in message entry after a
  253.          canceled comment to SysOp.
  254.  
  255.  
  256.  
  257.     INSTALLING RBBS-PC                                                      2-5
  258.  
  259.  
  260.     (f)  problems fixed  with the callers  log include  time logged  on is  not
  261.          right when  join conferences,  and  more information  is included  for
  262.          local users.
  263.  
  264.     (g)  Features were  added to the Fast  File Search to better  support macro
  265.          processing (see section 12.9).
  266.  
  267.     (h)  The  documentation was also rewritten in 17.3A.  Many new examples and
  268.          explanations of features were added.
  269.  
  270.     (i)  The  conference V)iew command now  resumes any listing  after the last
  271.          conference listed, rather than restarting at the top each time."
  272.  
  273.     Previously, version 17.3 of RBBS-PC added the following enhancements:
  274.  
  275.     (a)  Search for a  file's existence on upload and download  has been vastly
  276.          speeded up.   Based on an  indexed binary search  of a sorted  list of
  277.          file names.
  278.  
  279.     (b)  Data  base function  to forward  search (jump  to a line  containing a
  280.          particular string and continue from there)  was added for all file and
  281.          text displays
  282.  
  283.     (c)  NEWS facility  that  automatically  displays  news since  last  on  to
  284.          callers
  285.  
  286.     (d)  Callers can now stack commands to virtually any depth, and stacking is
  287.          consistently supported everywhere.
  288.  
  289.     (e)  Modem commands can be selected based on modem model.
  290.  
  291.     (f)  Users may now  FORWARD their mail  to another user.   SysOps or  users
  292.          having sufficient security to edit a message  can forward it to anyone
  293.          as well as change anything in the message header.
  294.  
  295.     (g)  The MSG  header Security  change now  allows the SysOp  to change  ANY
  296.          field in the header.
  297.  
  298.     (h)  When reading mail, the SysOp can instantly edit the USER record of the
  299.          message sender, then return to reading.
  300.  
  301.     The specific enhancements added include:
  302.  
  303.     (1)  When you have insufficient  time to download all the  files requested,
  304.          RBBS-PC will inform you of the  files omitted but try to download what
  305.          there is time for instead of canceling the entire download request.
  306.  
  307.     (2)  Timelock message now shows minutes & seconds left in time lock.
  308.  
  309.     (3)  Command  stacking  now supported  consistently  and  to virtually  any
  310.          depth.
  311.  
  312.     (4)  Autopage message less stiff and formal when caller notified that SysOp
  313.          wanted to know caller logged on.
  314.  
  315.     (5)  Chat time  given back when  SysOp initiates chat and  no longer counts
  316.          against session time.
  317.  
  318.     (6)  Conference name added to message header.
  319.  
  320.  
  321.  
  322.     RBBS-PC 17.3A            TECHNICAL REFERENCE MANUAL                     2-6
  323.  
  324.  
  325.     (7)  Support for new ZIP imploded compression.
  326.  
  327.     (8)  NEWS  facility added.    Special bulletin  displayed automatically  on
  328.          logon when updated since user last on.
  329.  
  330.     (9)  Message quoting first gives the  edit command prompt but tells how  to
  331.          continue adding to a reply.
  332.  
  333.     (10) Default extension automatically added to uploads and downloads when no
  334.          extension is specified
  335.  
  336.     (11) Forward search added to all directory displays and text file displays
  337.  
  338.     (12) Delays and embedded returns can be put into modem control strings.
  339.  
  340.     (13) Caller shown on welcome line if connection is reliable
  341.  
  342.     (14) SmartText  can  control  whether  substituted  value  is  inserted  or
  343.          overlaid
  344.  
  345.     (15) SmartText can  control whether substituted value is trimmed of leading
  346.          and trailing spaces first
  347.  
  348.     (16) Caller  is informed  when  session time  is  shortened because  of  an
  349.          external net mail event.
  350.  
  351.     (17) Can use "s" for since  last listed on file N)ew command (e.g.  "n s u"
  352.          for list new files since last on in upload directory).
  353.  
  354.     (18) When replying  to a  message, will  automatically  continue if  person
  355.          sending mail to is not in the user's file, rather than asking the user
  356.          whether wants to re-enter name or continue.
  357.  
  358.     (19) Macro questions can have edits  forcing answer to be one of  a list or
  359.          between two values.
  360.  
  361.     (20) Protocols to be used  to download and upload can be specified anywhere
  362.          in stacked command line rather than just on end.
  363.  
  364.     (21) File searches  on up and downloads have been vastly speeded up.  Makes
  365.          a huge different on slow devices like CD-ROMs.  Also,  have ability to
  366.          trigger OFF LINE processing for files elsewhere.
  367.  
  368.     (22) CONFIG gives option to set modem commands based on modem  model.  Uses
  369.          external file  MODEMS.SET in default  drive/path.  Makes  RBBS-PC much
  370.          easier to set up.
  371.  
  372.     (23) SysOps can now track UL/DL's and have a "free download" period.
  373.  
  374.     (24) SysOps can now explain exactly what a REGISTRATION EXPIRES means.  The
  375.          HELP file  RGXPIRE.HLP is seen when a  user is warned, and RGXPIRD.HLP
  376.          is seen when RBBS-PC reduces a caller's access.
  377.  
  378.     (25) Support for 38,400 bps, but only through Fossil drivers.
  379.  
  380.     (26) Can have multiple extensions searched when trying to detect  duplicate
  381.          on upload (new CONFIG parm 169).
  382.  
  383.  
  384.  
  385.     INSTALLING RBBS-PC                                                      2-7
  386.  
  387.  
  388.     2.3 Upgrading To 17.3A
  389.     ----------------------
  390.     17.3A is virtually "plug compatible" with 17.3.  You need only:
  391.  
  392.        - replace RBBS-PC.EXE and CONFIG.EXE with the new versions
  393.        - add the new help file "HELP07" to your other help files
  394.        - in parameter 225 of CONFIG,  add "AT" in front of your  firmware write
  395.          command
  396.        - replace your MODEMS.SET with the new one
  397.        - replace MENU5C, for doors, with the new one (edit in your door names),
  398.          unless yours is not based on the standard one
  399.  
  400.     When upgrading from a version PRIOR to 17.3, follow these steps:
  401.  
  402.     1.   Do  not  destroy or  overwrite  your  old files.    You  may run  into
  403.          difficulties and  have to fall  back to  the old version.   Especially
  404.          keep a  backup of  your current  USERS, MESSAGES, configuration  "DEF"
  405.          files, and your RBBS-PC.EXE and CONFIG.EXE files.
  406.  
  407.     2.   Start by trying to get the new version just to run equivalently to the
  408.          old  without implementing new features.  Implement new features one at
  409.          a time.  Do not try to implement everything new at once.
  410.  
  411.     3.   The file  that almost always changes  between non-maintenance versions
  412.          is  a configuration "DEF" file.  A utility program called RECONFIG.EXE
  413.          is provided that converts  all versions from 14.1D  on to the  latest.
  414.          This will save you the trouble of manually re-entering the parameters.
  415.          If  you do not have RECONFIG you  should print out all the options you
  416.          selected on your current RBBS?PC.DEF file.
  417.  
  418.     4.   CONFIG.EXE  has an option to  review the parameters  changed since the
  419.          last  version.   You should always  run this  to see  what is  new and
  420.          possibly  change  the  values.   If  you  do  not  have RECONFIG,  you
  421.          generally  need to delete  your current RBBS?PC.DEF  file and manually
  422.          enter the parameters.  Sometimes, however, the same parameters will be
  423.          in a different  place in the new configuration.   If you are upgrading
  424.          from several versions back, there is no simple way of knowing what all
  425.          is new.
  426.  
  427.     5.   The MESSAGES  and USERS files are  the two that are  most important to
  428.          continue to  be able  to  use.   RBBS-PC 17.3  is  compatible on  both
  429.          accounts with files  at least back through version 14.  However, there
  430.          is a  critical parameter  to set  in CONFIG:  the minimum  security to
  431.          auto-add a user  to a  conference.   This applies  to conferences  not
  432.          sub-boards, i.e. that have no configuration DEF file.  Go into CONFIG,
  433.          conference mode, and  then check this value.   No one will be  able to
  434.          join the conference if their  security is below this number,  even the
  435.          SysOp.   Reset this  value so  that the desired  callers can  join the
  436.          conference.
  437.  
  438.     6.   RBBS-PC  is  written  to  be  upward  compatible,  preserving all  the
  439.          functions  of earlier versions.  However, you may have to make changes
  440.          to the new  configuration to make it  run equivalently.   If upgrading
  441.          from 17.2x, you need to consider the following:
  442.  
  443.          (a)  replace RBBS-PC.EXE and CONFIG.EXE
  444.  
  445.  
  446.  
  447.     RBBS-PC 17.3A            TECHNICAL REFERENCE MANUAL                     2-8
  448.  
  449.  
  450.          (b)  If you want file  a)ll to list multiple physical  directory files
  451.               (as  opposed to say just the FMS  master file), then you must set
  452.               up RBBS-PC differently (see CONFIG parameter 218).
  453.  
  454.          (c)  If you turned  on "enforce  ratios", but exempted  all security
  455.               levels  (this   tells  RBBS-PC   to  track,  but   not  restrict,
  456.               downloads), you must  change the ratio (parameter 9  in PASSWRDS)
  457.               to  -1 in order for the code  to work equivalently.  Similarly, a
  458.               ratio of  0 will  not even  COUNT the  downloads.   (This  allows
  459.               "free" periods of downloading to be specified.)
  460.  
  461.     7.  If upgrading from 17.1, you need especially to consider:
  462.  
  463.          (a)  the  minimum security to read and kill  all messages.  If this is
  464.               set to 0, everybody can read everyone else's mail!
  465.  
  466.          (b)  RBBS-PC  formerly supported  the "arc"  format exclusively.   Now
  467.               "zip" is its default,  but it can be set up for  any.  Review the
  468.               parameters for default extension and archiving command.
  469.  
  470.          (c)  Your  personal directory  may  not  work  unless  you  include  a
  471.               drive/path.  Re-enter the parameter value in CONFIG.
  472.  
  473.     6.   If you  are  upgrading from  a  version prior  to  17.1, consider  the
  474.          possibility that the PASSWRDS  file may have a different  format, that
  475.          external protocols  are controlled  by an external  table (PROTO.DEF),
  476.          that the  doors interface  may be  different, and  the control  for an
  477.          timed even  may be different.  See section 10 for information on these
  478.          CONFIG parameters.
  479.  
  480.     9.   Use the new text  files, especially the menus and help  files.  If you
  481.          have customized versions  of these, start  with the distributed  files
  482.          and change them.
  483.  
  484.     10.  Review  the documentation on the major areas of enhancements.  Section
  485.          26 on  the history of RBBS-PC briefly reviews the enhancements in each
  486.          version  of  RBBS-PC.   Some specific  things  that you  want  to take
  487.          advantage of include:
  488.  
  489.          (a)  Macros and  SmartText have  been significantly improved  in 17.3.
  490.               You no longer need  to include a "{ST"  at the end of macros  and
  491.               will probably  want to  omit it.   You may  want to  enhance your
  492.               menus as well.  See the revised sections on SmartText and Macros.
  493.  
  494.          (b)  You may want to make file  searches faster and reduce the wear on
  495.               your hard disk by  installing the fast  file search system.   See
  496.               section 12.9.
  497.  
  498.          (c)  You  may want to  create a new  category of system  bulletins - a
  499.               NEWS facility (see section 7.13).
  500.  
  501.     The major changes in 17.2A were:
  502.  
  503.     (a)  use of shelling triggered by the presence of BAT files to test uploads
  504.          for integrity,  convert  uploads to  a different  format, and  support
  505.          viewing  of  text  files  inside  ZIP  files,  and  verbose  list  any
  506.          compressed format,
  507.  
  508.  
  509.  
  510.     INSTALLING RBBS-PC                                                      2-9
  511.  
  512.  
  513.     (b)  greatly enhanced  macros and  questionnaires, including new  data base
  514.          functions,
  515.  
  516.     (c)  enhanced doors interface, including an external control file for doors
  517.          (DOORS.DEF)  as well as the ability of  a door to request that RBBS-PC
  518.          change  the user record (DOUTx.DEF), pass  any information via command
  519.          line or a file to a door, and  for a door to return information to  be
  520.          displayed to the caller
  521.  
  522.     (d)  the message files can be  configured to have minimum size to  hold the
  523.          messages and let grow in size as new messages are added,
  524.  
  525.     (e)  conferences and  sub-boards can be configured  to automatically change
  526.          the user's security to match the logon security,
  527.  
  528.     (f)  message  quoting, allowing  the  option  to type  in  be  the same  on
  529.          different  submenus  and be  a  single  keystroke, speech  synthesizer
  530.          support  for  visually  impaired SysOps,  making  uploads  immediately
  531.          shareable  on  Novell  networks, an  easy  way  to  give a  conference
  532.          moderator  access  to all  mail without  having  to make  them SysOps,
  533.          chained FMS directories, and more.
  534.  
  535.     PLEASE  NOTE!!!!! ----  17.3  does NOT  change the  structure of  the user,
  536.     message, or DEF files from that in 17.2.
  537.  
  538.     2.4 Common Problems Encountered Installing RBBS-PC
  539.     --------------------------------------------------
  540.     IT CONTINUALLY  RECYCLES!  This can have several causes.  RBBS-PC  requires
  541.     that a modem be attached to your communications port.  Therefore:
  542.  
  543.        - check what communication port is being used.
  544.        - verify that this communications port exists.
  545.        - verify that your modem is attached to it.
  546.        - verify that your modem is powered up.
  547.        - verify that your modem is configured properly.
  548.        - verify that CONFIG knows what kind of modem you're using.
  549.        - verify  that  the modem  cable supports  all  ten signals  required by
  550.          RBBS-PC (see Appendix F).
  551.        - verify that DTR (Data Terminal Ready) and CD  (Carrier Detect) are set
  552.          to  "normal" rather  than  always "on"  (sometimes  called "true"  and
  553.          "forced" instead).
  554.        - verify that each DOS subdirectory referred to in CONFIG exists.
  555.        - verify that  RBBS-PC runs properly  when set  up to use  COM0 (i.e.  a
  556.          local workstation).
  557.  
  558.     If, after  all of the above has been attempted, the problem still persists,
  559.     try deleting your MESSAGES and USERS files and re-run CONFIG  to create new
  560.     ones.
  561.  
  562.     Finally, having exhausted all  the above remedies, the system  continues to
  563.     continually re-cycle, you may have an incompatible "clone" PC, incompatible
  564.     DOS, incompatible modem, and/or a bad copy of RBBS-PC.EXE.
  565.  
  566.     IT WON'T ANSWER THE PHONE!  This also can be caused by one of the following
  567.     things:
  568.  
  569.        - Phone line is not plugged into the modem.
  570.        - Modem is not powered on.
  571.  
  572.  
  573.  
  574.     RBBS-PC 17.3A            TECHNICAL REFERENCE MANUAL                    2-10
  575.  
  576.  
  577.        - Modem is not  connected to  the communications port  that RBBS-PC  was
  578.          told to use.
  579.        - Your modem switches or firmware is not set (see CONFIG parameter 231).
  580.        - Your  modem is  not  "Hayes compatible"  enough  to handle  the  modem
  581.          commands described in section 11.
  582.        - Your modem cable does not have Pin 22 connected.
  583.  
  584.     There are two conditions under which RBBS-PC does not require Pin 22 in the
  585.     RS-232 cable to reflect the status of "ring".
  586.  
  587.     RBBS-PC does not require Pin 22 to be hooked up on the RS-232 cable (that's
  588.     the cable  which runs between the  modem and the computer, by  the way), if
  589.     you specify in  CONFIG that RBBS-PC is  to answer the phone  on zero rings,
  590.     and that  it is  not a "RING-BACK"  system.   In this setting  RBBS-PC will
  591.     initialize the modem so that the modem AUTOMATICALLY answers the phone.
  592.  
  593.     RBBS-PC also does  not require Pin  22 to reflect  the status of  ring when
  594.     your modem  returns the result  code "RING" as the  phone is ringing.   The
  595.     default setting for  RBBS-PC is that  it depends on  either Pin 22, or  the
  596.     modem result  code "RING",  to know  when the  phone is ringing.   This  is
  597.     because RBBS-PC,  and NOT the  modem, answers the  phone.  When  RBBS-PC is
  598.     informed by  the modem that  the phone is  ringing, it counts  the rings by
  599.     issuing  the "ATS1?"  command.  When  the number  of rings  has reached the
  600.     number you told CONFIG you wanted  to answer after, RBBS-PC sends the "ATA"
  601.     command to tell the modem to answer the phone (see section 11).
  602.  
  603.     If  your modem  does NOT  send the  characters "RING"  each time  the phone
  604.     rings,  you will need a cable with  Pin 22 connected.  Some computers (such
  605.     as the PCjr's external RS-232 interface) and some modem cables don't have a
  606.     "ring-indicator"  signal.   Pin 22  is the ring  indicator coming  from the
  607.     modem going to the computer.  And  just because you bought an RS-232 cable,
  608.     don't assume that it has Pin 22 connected.  This is often not the case.
  609.  
  610.     IT LOCKS UP MY SYSTEM!  This may be caused by one of the following things:
  611.  
  612.        - The .EXE file  generated by  the BASIC compiler  is incompatible  with
  613.          either the DOS that you  are running (i.e. it isn't IBM's  PC-DOS), or
  614.          other software you load into the system prior to running RBBS-PC (such
  615.          as a  device driver loaded in  CONFIG.SYS, or a TSR  program loaded in
  616.          your  AUTOEXEC.BAT file).   Remove  all non-essential  memory resident
  617.          software.
  618.  
  619.        - You indicated  in CONFIG that  you were  running one of  the supported
  620.          networks (i.e. CORVUS, MultiLink, Orchid, etc.), but you aren't.
  621.  
  622.        - You  are running on  a COMPAQ DeskPro,  or using an  add-on board that
  623.          uses the unused IBM DOS interrupt 7F hex, and should  have used CONFIG
  624.          parameter 29 to indicate you are using a COMPAQ PC.
  625.  
  626.        - Your  modem isn't  set up  correctly, probably  not supplying  us with
  627.          "true"  carrier  detect (i.e.  the  modem tells  us  that a  caller is
  628.          connected  when  that's   not  true).    Try  selecting   "Hayes  2400
  629.          compatible"  as the  modem type  in CONFIG,  and use parameter  231 to
  630.          re-program the modem's firmware.
  631.  
  632.        - RBBS-PC  is trying to log  to a printer that does  not exist or is not
  633.          turned  on, or  out of  paper, and  no error  condition is  ever being
  634.          returned back  to RBBS.  In  CONFIG, tell RBBS-PC to  turn the printer
  635.          off after each recycle (parameter 52).
  636.  
  637.  
  638.  
  639.     INSTALLING RBBS-PC                                                     2-11
  640.  
  641.  
  642.        - Your  system does  not support  standard DOS  system calls  for screen
  643.          writes.   Try  setting CONFIG  parameter  39 to  use BASIC  for screen
  644.          writes.
  645.  
  646.        - Your  system is  not as  PC compatible  as it  should be  and may  use
  647.          strange  interrupts.   Try turning  assembler routines  off (parameter
  648.          38).
  649.  
  650.